home *** CD-ROM | disk | FTP | other *** search
/ HPAVC / HPAVC CD-ROM.iso / pc / UGPRG.ZIP / DENTHOR / TUT7.DOC < prev    next >
Encoding:
Text File  |  1996-07-27  |  46.6 KB  |  1,190 lines
  1.                    ╒═══════════════════════════════╕
  2.                    │         W E L C O M E         │
  3.                    │  To the VGA Trainer Program   │ │
  4.                    │              By               │ │
  5.                    │      DENTHOR of ASPHYXIA      │ │ │
  6.                    ╘═══════════════════════════════╛ │ │
  7.                      ────────────────────────────────┘ │
  8.                        ────────────────────────────────┘
  9.  
  10.                            --==[ PART 7 ]==--
  11.  
  12.  
  13.  
  14. =-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=
  15. ■ Introduction
  16.  
  17. Hello! By popular request, this part is all about animation. I will be
  18. going over three methods of doing animation on a PC, and will
  19. concerntrate specifically on one, which will be demonstrated in the
  20. attached sample code.
  21.  
  22. Although not often used in demo coding, animation is usually used in
  23. games coding, which can be almost as rewarding ;-)
  24.  
  25. In this part I will also be a lot less stingy with assembler code :)
  26. Included will be a fairly fast pure assembler putpixel, an asm screen
  27. flip command, an asm icon placer, an asm partial-flip and one or two
  28. others. I will be explaining how these work in detail, so this may also
  29. be used as a bit of an asm-trainer too.
  30.  
  31. By the way, I apologise for this part taking so long to be released, but
  32. I only finished my exams a few days ago, and they of course took
  33. preference ;-). I have also noticed that the MailBox BBS is no longer
  34. operational, so the trainer will be uploaded regularly to the BBS lists
  35. shown at the end of this tutorial.
  36.  
  37. If you would like to contact me, or the team, there are many ways you
  38. can do it : 1) Write a message to Grant Smith/Denthor/Asphyxia in private mail
  39.                   on the ASPHYXIA BBS.
  40.             2) Write a message in the Programming conference on the
  41.                   For Your Eyes Only BBS (of which I am the Moderator )
  42.                   This is preferred if you have a general programming query
  43.                   or problem others would benefit from.
  44.             4) Write to Denthor, Eze or Livewire on Connectix.
  45.             5) Write to :  Grant Smith
  46.                            P.O.Box 270 Kloof
  47.                            3640
  48.                            Natal
  49.             6) Call me (Grant Smith) at (031) 73 2129 (leave a message if you
  50.                   call during varsity)
  51.             7) Write to mcphail@beastie.cs.und.ac.za on InterNet, and
  52.                   mention the word Denthor near the top of the letter.
  53.  
  54. NB : If you are a representative of a company or BBS, and want ASPHYXIA
  55.        to do you a demo, leave mail to me; we can discuss it.
  56. NNB : If you have done/attempted a demo, SEND IT TO ME! We are feeling
  57.         quite lonely and want to meet/help out/exchange code with other demo
  58.         groups. What do you have to lose? Leave a message here and we can work
  59.         out how to transfer it. We really want to hear from you!
  60.  
  61.  
  62.  
  63. =-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=
  64. ■  The Principals of Animation
  65.  
  66. I am sure all of you have seen a computer game with animation at one or
  67. other time. There are a few things that an animation sequence must do in
  68. order to give an impression of realism. Firstly, it must move,
  69. preferably using different frames to add to the realism (for example,
  70. with a man walking you should have different frames with the arms an
  71. legs in different positions). Secondly, it must not destroy the
  72. background, but restore it after it has passed over it.
  73.  
  74. This sounds obvious enough, but can be very difficult to code when you
  75. have no idea of how to go about achieving that.
  76.  
  77. In this trainer I will discuss various methods of meeting these two
  78. objectives.
  79.  
  80.  
  81.  
  82. =-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=
  83. ■  Frames and Object Control
  84.  
  85. It is quite obvious that for most animation to succeed, you must have
  86. numerous frames of the object in various poses (such as a man with
  87. several frames of him walking). When shown one after the other, these
  88. give the impression of natural movement.
  89.  
  90. So, how do we store these frames? I hear you cry. Well, the obvious
  91. method is to store them in arrays. After drawing a frame in Autodesk
  92. Animator and saving it as a .CEL, we usually use the following code to
  93. load it in :
  94.  
  95. TYPE icon = Array [1..50,1..50] of byte;
  96.  
  97. VAR tree : icon;
  98.  
  99. Procedure LoadCEL (FileName :  string; ScrPtr : pointer);
  100. var
  101.   Fil : file;
  102.   Buf : array [1..1024] of byte;
  103.   BlocksRead, Count : word;
  104. begin
  105.   assign (Fil, FileName);
  106.   reset (Fil, 1);
  107.   BlockRead (Fil, Buf, 800);    { Read and ignore the 800 byte header }
  108.   Count := 0; BlocksRead := $FFFF;
  109.   while (not eof (Fil)) and (BlocksRead <> 0) do begin
  110.     BlockRead (Fil, mem [seg (ScrPtr^): ofs (ScrPtr^) + Count], 1024, BlocksRead);
  111.     Count := Count + 1024;
  112.   end;
  113.   close (Fil);
  114. end;
  115.  
  116. BEGIN
  117.   Loadcel ('Tree.CEL',addr (tree));
  118. END.
  119.  
  120. We now have the 50x50 picture of TREE.CEL in our array tree. We may access
  121. this array in the usual manner (eg. col:=tree [25,30]). If the frame is
  122. large, or if you have many frames, try using pointers (see previous
  123. parts)
  124.  
  125. Now that we have the picture, how do we control the object? What if we
  126. want multiple trees wandering around doing their own thing? The solution
  127. is to have a record of information for each tree. A typical data
  128. structure may look like the following :
  129.  
  130. TYPE Treeinfo = Record
  131.                   x,y:word;       { Where the tree is }
  132.                   speed:byte;     { How fast the tree is moving }
  133.                   Direction:byte; { Where the tree is facing }
  134.                   frame:byte      { Which animation frame the tree is
  135.                                     currently involved in }
  136.                   active:boolean; { Is the tree actually supposed to be
  137.                                     shown/used? }
  138.                 END;
  139.  
  140. VAR Forest : Array [1..20] of Treeinfo;
  141.  
  142. You now have 20 trees, each with their own information, location etc.
  143. These are accessed using the following means :
  144.                   Forest [15].x:=100;
  145. This would set the 15th tree's x coordinate to 100.
  146.  
  147.  
  148.  
  149. =-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=
  150. ■  Restoring the Overwritten Background
  151.  
  152. I will discuss three methods of doing this. These are NOT NECESSARILY
  153. THE ONLY OR BEST WAYS TO DO THIS! You must experiment and decide which
  154. is the best for your particular type of program.
  155.  
  156. METHOD 1 :
  157.  
  158. Step 1 : Create two virtual pages, Vaddr and Vaddr2.
  159. Step 2 : Draw the background to Vaddr2.
  160. Step 3 : Flip Vaddr2 to Vaddr.
  161. Step 4 : Draw all the foreground objects onto Vaddr.
  162. Step 5 : Flip Vaddr to VGA.
  163. Step 6 : Repeat from 3 continuously.
  164.  
  165. In ascii, it looks like follows ...
  166.  
  167.     +---------+           +---------+           +---------+
  168.     |         |           |         |           |         |
  169.     |  VGA    | <=======  |  VADDR  |  <======  |  VADDR2 |
  170.     |         |           | (bckgnd)|           | (bckgnd)|
  171.     |         |           |+(icons) |           |         |
  172.     +---------+           +---------+           +---------+
  173.  
  174. The advantages of this approach is that it is straightforward, continual
  175. reading of the background is not needed, there is no flicker and it is
  176. simple to implement.  The disadvantages are that two 64000 byte virtual
  177. screens are needed, and the procedure is not very fast because of the
  178. slow speed of flipping.
  179.  
  180.  
  181. METHOD 2 :
  182.  
  183. Step 1 : Draw background to VGA.
  184. Step 2 : Grab portion of background that icon will be placed on.
  185. Step 3 : Place icon.
  186. Step 4 : Replace portion of background from Step 2 over icon.
  187. Step 5 : Repeat from step 2 continuously.
  188.  
  189. In terms of ascii ...
  190.  
  191.       +---------+
  192.       |      +--|------- + Background restored (3)
  193.       |      * -|------> * Background saved to memory (1)
  194.       |      ^  |
  195.       |      +--|------- # Icon placed (2)
  196.       +---------+
  197.  
  198. The advantages of this method is that very little extra memory is
  199. needed. The disadvantages are that writing to VGA is slower then writing
  200. to memory, and there may be large amounts of flicker.
  201.  
  202.  
  203. METHOD 3 :
  204.  
  205. Step 1 : Set up one virtual screen, VADDR.
  206. Step 2 : Draw background to VADDR.
  207. Step 3 : Flip VADDR to VGA.
  208. Step 4 : Draw icon to VGA.
  209. Step 5 : Transfer background portion from VADDR to VGA.
  210. Step 6 : Repeat from step 4 continuously.
  211.  
  212. In ascii ...
  213.  
  214.      +---------+           +---------+
  215.      |         |           |         |
  216.      |   VGA   |           |  VADDR  |
  217.      |         |           | (bckgnd)|
  218.      | Icon>* <|-----------|--+      |
  219.      +---------+           +---------+
  220.  
  221. The advantages are that writing from the virtual screen is quicker then
  222. from VGA, and there is less flicker then in Method 2. Disadvantages are
  223. that you are using a 64000 byte virtual screen, and flickering occurs
  224. with large numbers of objects.
  225.  
  226. In the attached sample program, a mixture of Method 3 and Method 1 is
  227. used. It is faster then Method 1, and has no flicker, unlike Method 3.
  228. What I do is I use VADDR2 for background, but only restore the
  229. background that has been changed to VADDR, before flipping to VGA.
  230.  
  231. In the sample program, you will see that I restore the entire background
  232. of each of the icons, and then place all the icons. This is because if I
  233. replace the background then place the icon on each object individually,
  234. if two objects are overlapping, one is partially overwritten.
  235.  
  236. The following sections are explanations of how the various assembler
  237. routines work. This will probably be fairly boring for you if you
  238. already know assembler, but should help beginners and dabblers alike.
  239.  
  240.  
  241. =-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=
  242. ■  The ASM Putpixel
  243.  
  244. To begin with, I will explain a few of the ASM variables and functions :
  245.  
  246. <NOTE THAT THIS IS AN EXTREMELY SIMPLISTIC VIEW OF ASSEMBLY LANGUAGE!
  247. There are numerous books to advance your knowledge, and the Norton
  248. Guides assembler guide  may be invaluable for people beginning to code
  249. in assembler. I haven't given you the pretty pictures you are supposed
  250. to have to help you understand it easier, I have merely laid it out like
  251. a programming language with it's own special procedures. >
  252.  
  253. There are 4 register variables : AX,BX,CX,DX. These are words (double
  254. bytes) with a range from 0 to 65535. You may access the high and low
  255. bytes of these by replacing the X with a "H" for high or "L" for low.
  256. For example, AL has a range from 0-255.
  257.  
  258. You also have two pointers : ES:DI and DS:SI. The part on the left is
  259. the segment to which you are pointing (eg $a000), and the right hand
  260. part is the offset, which is how far into the segment you are pointing.
  261. Turbo Pascal places a variable over 16k into the base of a segment, ie.
  262. DI or SI will be zero at the start of the variable.
  263.  
  264. If you wish to be pointing to pixel number 3000 on the VGA screen (see
  265. previous parts for the layout of the VGA screen), ES would be equal to
  266. $a000 and DI would be equal to 3000.  You can quite as easily make ES or
  267. DS be equal to the offset of a virtual screen.
  268.  
  269. Here are a few functions that you will need to know :
  270.  
  271.       mov   destination,source       This moves the value in source to
  272.                                      destination. eg  mov ax,50
  273.       add   destination,source       This adds source to destination,
  274.                                      the result being stored in destination
  275.       mul   source                   This multiplies AX by source. If
  276.                                      source is a byte, the source is
  277.                                      multiplied by AL, the result being
  278.                                      stored in AX. If source is a word,
  279.                                      the source is multiplied by AX, the
  280.                                      result being stored in DX:AX
  281.       movsb                          This moves the byte that DS:SI is
  282.                                      pointing to into ES:DI, and
  283.                                      increments SI and DI.
  284.       movsw                          Same as movsb except it moves a
  285.                                      word instead of a byte.
  286.       stosw                          This moves AX into ES:DI. stosb
  287.                                      moves AL into ES:DI. DI is then
  288.                                      incremented.
  289.       push register                  This saves the value of register by
  290.                                      pushing it onto the stack. The
  291.                                      register may then be altered, but
  292.                                      will be restored to it's original
  293.                                      value when popped.
  294.       pop register                   This restores the value of a pushed
  295.                                      register. NOTE : Pushed values must
  296.                                      be popped in the SAME ORDER but
  297.                                      REVERSED.
  298.       rep  command                   This repeats Command by as many
  299.                                      times as the value in CX
  300.  
  301.  
  302. SHL Destination,count      ;
  303. and SHR Destination,count  ;
  304. need a bit more explaining. As you know, computers think in ones and
  305. zeroes. Each number may be represented in this base 2 operation. A byte
  306. consists of 8 ones and zeroes (bits), and have a range from 0 to 255. A 
  307. word consists of 16 ones and zeroes (bits), and has a range from 0 to 
  308. 65535. A double word consists of 32 bits.
  309.  
  310. The number 53 may be represented as follows :  00110101.  Ask someone who
  311. looks clever to explain to you how to convert from binary to decimal and
  312. vice-versa.
  313.  
  314. What happens if you shift everything to the left? Drop the leftmost
  315. number and add a zero to the right? This is what happens :
  316.  
  317.                 00110101     =  53
  318.                  <-----
  319.                 01101010     =  106
  320.  
  321. As you can see, the value has doubled! In the same way, by shifting one
  322. to the right, you halve the value! This is a VERY quick way of
  323. multiplying or dividing by 2. (note that for dividing by shifting, we
  324. get the trunc of the result ... ie.  15 shr 1 = 7)
  325.  
  326. In assembler the format is SHL destination,count    This shifts
  327. destination by as many bits in count (1=*2, 2=*4, 3=*8, 4=*16 etc)
  328. Note that a shift takes only 2 clock cycles, while a mul can take up to 133
  329. clock cycles. Quite a difference, no? Only 286es or above may have count
  330. being greater then one.
  331.  
  332. This is why to do the following to calculate the screen coordinates for
  333. a putpixel is very slow :
  334.  
  335.            mov    ax,[Y]
  336.            mov    bx,320
  337.            mul    bx
  338.            add    ax,[X]
  339.            mov    di,ax
  340.  
  341. But alas! I hear you cry. 320 is not a value you may shift by, as you
  342. may only shift by 2,4,8,16,32,64,128,256,512 etc.etc. The solution is
  343. very cunning. Watch.
  344.  
  345.     mov     bx,[X]
  346.     mov     dx,[Y]
  347.     push    bx
  348.     mov     bx, dx                  {; bx = dx = Y}
  349.     mov     dh, dl                  {; dh = dl = Y}
  350.     xor     dl, dl                  {; These 2 lines equal dx*256 }
  351.     shl     bx, 1
  352.     shl     bx, 1
  353.     shl     bx, 1
  354.     shl     bx, 1
  355.     shl     bx, 1
  356.     shl     bx, 1                   {; bx = bx * 64}
  357.     add     dx, bx                  {; dx = dx + bx (ie y*320)}
  358.     pop     bx                      {; get back our x}
  359.     add     bx, dx                  {; finalise location}
  360.     mov     di, bx
  361.  
  362. Let us have a look at this a bit closer shall we?
  363. bx=dx=y        dx=dx*256  ;   bx=bx*64     ( Note, 256+64 = 320 )
  364.  
  365. dx+bx=Correct y value, just add X!
  366.  
  367. As you can see, in assembler, the shortest code is often not the
  368. fastest.
  369.  
  370. The complete putpixel procedure is as follows :
  371.  
  372. Procedure Putpixel (X,Y : Integer; Col : Byte; where:word);
  373.   { This puts a pixel on the screen by writing directly to memory. }
  374. BEGIN
  375.   Asm
  376.     push    ds                      {; Make sure these two go out the }
  377.     push    es                      {; same they went in }
  378.     mov     ax,[where]
  379.     mov     es,ax                   {; Point to segment of screen }
  380.     mov     bx,[X]
  381.     mov     dx,[Y]
  382.     push    bx                      {; and this again for later}
  383.     mov     bx, dx                  {; bx = dx}
  384.     mov     dh, dl                  {; dx = dx * 256}
  385.     xor     dl, dl
  386.     shl     bx, 1
  387.     shl     bx, 1
  388.     shl     bx, 1
  389.     shl     bx, 1
  390.     shl     bx, 1
  391.     shl     bx, 1                   {; bx = bx * 64}
  392.     add     dx, bx                  {; dx = dx + bx (ie y*320)}
  393.     pop     bx                      {; get back our x}
  394.     add     bx, dx                  {; finalise location}
  395.     mov     di, bx                  {; di = offset }
  396.     {; es:di = where to go}
  397.     xor     al,al
  398.     mov     ah, [Col]
  399.     mov     es:[di],ah              {; move the value in ah to screen
  400.                                        point es:[di] }
  401.     pop     es
  402.     pop     ds
  403.   End;
  404. END;
  405.  
  406. Note that with DI and SI, when you use them :
  407.       mov   di,50      Moves di to position 50
  408.       mov   [di],50    Moves 50 into the place di is pointing to
  409.  
  410.  
  411. =-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=
  412. ■  The Flip Procedure
  413.  
  414. This is fairly straightforward. We get ES:DI to point to the start of
  415. the destination screen, and DS:SI to point to the start of the source
  416. screen, then do 32000 movsw (64000 bytes).
  417.  
  418. procedure flip(source,dest:Word);
  419.   { This copies the entire screen at "source" to destination }
  420. begin
  421.   asm
  422.     push    ds
  423.     mov     ax, [Dest]
  424.     mov     es, ax                  { ES = Segment of source }
  425.     mov     ax, [Source]
  426.     mov     ds, ax                  { DS = Segment of source }
  427.     xor     si, si                  { SI = 0   Faster then mov si,0 }
  428.     xor     di, di                  { DI = 0 }
  429.     mov     cx, 32000
  430.     rep     movsw                   { Repeat movsw 32000 times }
  431.     pop     ds
  432.   end;
  433. end;
  434.  
  435. The cls procedure works in much the same way, only it moves the color
  436. into AX then uses a rep stosw (see program for details)
  437.  
  438. The PAL command is almost exactly the same as it's Pascal equivalent
  439. (see previous tutorials). Look in the sample code to see how it uses the
  440. out and in commands.
  441.  
  442.  
  443. =-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=
  444. ■  In Closing
  445.  
  446. The assembler procedures presented to you in here are not at their best.
  447. Most of these are procedures ASPHYXIA abandoned for better ones after
  448. months of use. But, as you will soon see, they are all MUCH faster then
  449. the original Pascal equivalents I originally gave you. In future, I
  450. hope to give you more and more assembler procedures for your ever
  451. growing collections. But, as you know, I am not always very prompt with
  452. this series (I don't know if even one has been released within one week
  453. of the previous one), so if you want to get any stuff done, try do it
  454. yourself. What do you have to lose, aside from your temper and a few
  455. rather inventive reboots ;-)
  456.  
  457. What should I do for the next trainer? A simple 3-d tutorial? You may
  458. not like it, because I would go into minute detail of how it works :)
  459. Leave me suggestions for future trainers by any of the means discussed
  460. at the top of this trainer.
  461.  
  462. After the customary quote, I will place a listing of the BBSes I
  463. currently know that regularly carry this Trainer Series. If your BBS
  464. receives it regularly, no matter where in the country you are, get a
  465. message to me and I'll add it to the list. Let's make it more convenient
  466. for locals to grab a copy without calling long distance ;-)
  467.  
  468.             [  There they sit, the preschooler class encircling their
  469.                   mentor, the substitute teacher.
  470.                "Now class, today we will talk about what you want to be
  471.                   when you grow up. Isn't that fun?" The teacher looks
  472.                   around and spots the child, silent, apart from the others
  473.                   and deep in thought. "Jonny, why don't you start?" she
  474.                   encourages him.
  475.                Jonny looks around, confused, his train of thought
  476.                   disrupted. He collects himself, and stares at the teacher
  477.                   with a steady eye. "I want to code demos," he says,
  478.                   his words becoming stronger and more confidant as he
  479.                   speaks. "I want to write something that will change
  480.                   peoples perception of reality. I want them to walk
  481.                   away from the computer dazed, unsure of their footing
  482.                   and eyesight. I want to write something that will
  483.                   reach out of the screen and grab them, making
  484.                   heartbeats and breathing slow to almost a halt. I want
  485.                   to write something that, when it is finished, they
  486.                   are reluctant to leave, knowing that nothing they
  487.                   experience that day will be quite as real, as
  488.                   insightful, as good. I want to write demos."
  489.                Silence. The class and the teacher stare at Jonny, stunned. It
  490.                   is the teachers turn to be confused. Jonny blushes,
  491.                   feeling that something more is required.  "Either that
  492.                   or I want to be a fireman."
  493.                                                                      ]
  494.                                                        - Grant Smith
  495.                                                             14:32
  496.                                                                21/11/93
  497.  
  498. See you next time,
  499.   - DENTHOR
  500.  
  501. These fine BBS's carry the ASPHYXIA DEMO TRAINER SERIES : (alphabetical)
  502.  
  503. ╔══════════════════════════╦════════════════╦═════╦═══╦════╦════╗
  504. ║BBS Name                  ║Telephone No.   ║Open ║Msg║File║Past║
  505. ╠══════════════════════════╬════════════════╬═════╬═══╬════╬════╣
  506. ║ASPHYXIA BBS #1           ║(031) 765-5312  ║ALL  ║ * ║ *  ║ *  ║
  507. ║ASPHYXIA BBS #2           ║(031) 765-6293  ║ALL  ║ * ║ *  ║ *  ║
  508. ║Connectix BBS             ║(031) 266-9992  ║ALL  ║ * ║ *  ║ *  ║
  509. ║For Your Eyes Only BBS    ║(031) 285-318   ║A/H  ║ * ║ *  ║ *  ║
  510. ╚══════════════════════════╩════════════════╩═════╩═══╩════╩════╝
  511.  
  512. Open = Open at all times or only A/H
  513. Msg  = Available in message base
  514. File = Available in file base
  515. Past = Previous Parts available
  516. {$X+}
  517. USES crt;
  518.  
  519. CONST VGA = $a000;
  520.  
  521. Type Toastinfo = Record                 { This is format of of each of our }
  522.                  x,y:integer;              { records for the flying toasters }
  523.                  speed,frame:integer;
  524.                  active:boolean;
  525.                END;
  526.  
  527.      icon = Array [1..30*48] of byte;  { This is the size of our pictures }
  528.  
  529.      Virtual = Array [1..64000] of byte;  { The size of our Virtual Screen }
  530.      VirtPtr = ^Virtual;                  { Pointer to the virtual screen }
  531.  
  532. CONST frame1 : icon = (
  533. 0,0,0,0,5,5,5,5,5,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,5,5,5,5,5,5,5,
  534. 7,7,7,7,0,0,0,0,0,0,0,5,5,5,5,5,5,5,5,5,5,5,5,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,5,
  535. 5,7,7,7,7,7,7,7,8,8,7,7,7,7,7,7,0,5,5,5,5,5,5,5,5,5,5,5,5,5,5,5,0,0,0,0,0,0,0,0,
  536. 0,0,0,0,0,5,5,7,7,7,7,7,8,8,7,8,8,7,8,7,8,7,7,7,5,8,8,8,8,5,5,5,5,5,5,5,5,5,5,5,
  537. 5,0,0,0,0,0,0,0,0,0,0,0,5,7,7,7,7,7,7,8,7,7,7,8,7,7,7,7,7,7,0,0,0,0,0,0,8,5,5,5,
  538. 5,5,5,5,5,5,5,5,5,0,0,0,0,0,0,0,0,0,0,5,7,7,8,8,7,7,8,7,7,8,7,7,7,7,7,0,0,0,0,0,
  539. 0,0,0,0,0,0,5,5,5,5,5,5,5,5,5,5,5,5,0,0,0,0,0,0,0,0,5,7,8,8,8,7,7,8,7,7,8,7,7,7,
  540. 7,7,0,0,0,0,0,0,0,0,0,0,0,0,0,5,5,5,5,5,5,5,5,5,5,5,5,0,0,0,0,0,0,5,7,8,8,8,7,7,
  541. 8,8,8,8,8,8,7,7,0,0,0,0,0,0,0,0,0,0,0,0,0,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,9,9,9,9,
  542. 9,5,7,8,8,8,8,8,7,7,8,8,7,7,7,7,0,0,0,0,0,0,0,0,0,0,0,0,0,1,1,1,1,1,1,1,1,1,1,1,
  543. 1,1,1,1,9,9,9,9,5,7,7,8,8,8,8,7,7,8,8,7,7,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,1,1,
  544. 1,1,0,0,0,1,1,1,1,1,1,1,9,9,9,5,7,8,8,7,7,8,8,7,8,8,8,7,0,0,0,0,0,0,0,0,0,0,0,0,
  545. 0,0,0,0,0,0,1,1,1,1,0,0,0,1,1,1,1,1,1,1,1,1,1,5,7,8,8,7,7,7,7,8,8,7,7,7,0,0,0,0,
  546. 0,0,0,0,0,0,0,0,0,0,0,0,0,0,1,1,1,1,0,0,0,1,1,1,1,1,1,2,2,2,2,7,8,8,8,8,8,8,8,7,
  547. 7,7,2,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,1,1,1,1,0,0,0,1,1,1,1,1,1,2,2,2,2,7,
  548. 7,7,7,7,7,7,7,7,2,2,2,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,1,1,1,1,0,0,0,1,1,1,
  549. 1,1,1,2,2,2,2,2,2,2,2,2,2,2,2,2,2,2,2,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,1,1,
  550. 1,1,0,0,0,1,1,1,1,1,1,2,2,2,2,2,2,2,2,2,2,2,2,2,2,2,2,0,0,0,0,0,0,0,0,0,0,0,0,0,
  551. 0,0,0,0,0,0,1,1,1,1,0,0,0,1,1,1,1,1,1,2,2,2,2,2,2,2,2,2,2,2,2,2,2,2,2,0,0,0,0,0,
  552. 0,0,0,0,0,0,0,0,0,0,0,0,0,0,1,1,1,1,0,0,0,1,1,1,1,1,1,2,2,2,2,2,2,2,2,2,2,2,2,2,
  553. 2,2,2,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,1,1,1,1,0,0,0,1,1,1,1,1,1,2,2,2,2,2,
  554. 2,2,2,2,2,2,2,2,2,2,2,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,1,1,1,1,0,0,0,1,1,1,
  555. 1,1,1,2,2,2,2,2,2,2,2,2,2,2,2,2,2,2,2,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,1,4,
  556. 4,6,6,6,6,6,6,1,1,1,1,2,2,2,2,2,2,2,2,2,2,2,2,2,2,2,2,0,0,0,0,0,0,0,0,0,0,0,0,0,
  557. 0,0,0,0,0,0,1,1,1,1,1,1,1,1,2,2,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,0,0,0,0,0,
  558. 0,0,0,0,0,0,0,0,0,0,0,0,0,1,1,1,1,1,1,1,1,1,3,3,1,1,1,1,9,9,9,9,9,9,9,9,9,9,9,9,
  559. 9,9,9,9,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,9,9,9,9,
  560. 9,9,9,9,9,9,9,9,9,9,9,9,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,1,1,1,1,1,1,1,1,1,1,1,
  561. 1,1,1,1,9,9,9,9,9,9,9,9,9,9,9,9,9,9,9,9,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,
  562. 0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,
  563. 0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,
  564. 0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,
  565. 0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,
  566. 0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,
  567. 0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,
  568. 0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0
  569. );
  570.       frame2 : icon = (
  571. 0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,
  572. 0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,
  573. 0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,
  574. 0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,
  575. 0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,
  576. 0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,
  577. 0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,
  578. 0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,
  579. 0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,9,9,9,9,
  580. 9,9,9,9,9,9,9,9,9,9,9,9,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,1,1,1,1,1,1,1,1,1,1,1,
  581. 1,1,1,1,9,9,9,9,9,9,9,9,9,9,9,9,9,9,9,9,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,1,1,1,
  582. 1,1,0,0,0,1,1,1,1,1,1,1,9,9,9,9,9,9,9,9,9,9,9,9,9,9,9,9,0,0,0,0,0,0,0,0,0,0,0,0,
  583. 0,0,0,0,0,0,1,1,1,1,0,0,0,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,0,0,0,0,0,
  584. 0,0,0,0,0,0,0,0,0,0,0,0,0,0,1,1,1,1,0,0,0,1,1,1,1,1,1,2,2,2,2,2,2,2,2,2,2,2,2,2,
  585. 2,2,2,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,1,1,1,1,0,0,0,1,1,1,1,1,1,2,2,2,2,5,
  586. 5,5,5,5,5,5,5,2,2,2,2,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,1,1,1,1,0,0,0,1,1,1,
  587. 1,1,1,2,2,2,2,2,5,5,5,5,5,5,5,5,5,2,2,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,1,1,
  588. 1,1,0,0,0,1,1,1,1,1,1,2,2,2,2,2,2,5,5,5,5,5,5,5,5,5,2,0,0,0,0,0,0,0,0,0,0,0,0,0,
  589. 0,0,0,0,0,5,1,1,1,1,0,0,0,1,1,1,1,1,1,2,2,2,2,2,2,2,2,5,5,5,5,5,5,5,5,0,0,0,0,0,
  590. 0,0,0,0,0,0,0,0,0,0,0,0,5,5,1,1,1,1,0,0,0,1,1,1,1,1,1,2,2,2,2,2,2,2,2,2,5,5,5,5,
  591. 5,5,5,5,5,0,0,0,0,0,0,0,0,0,0,0,0,0,0,5,5,5,1,1,1,1,0,0,0,1,1,1,1,1,1,2,2,2,2,2,
  592. 2,2,2,2,2,5,5,5,5,5,5,5,5,5,0,0,0,0,0,0,0,0,0,0,0,0,0,5,1,1,1,1,1,1,0,0,0,1,1,1,
  593. 1,1,1,2,2,2,2,2,2,2,2,2,2,2,5,5,5,5,5,5,5,5,0,0,0,0,0,0,0,0,0,0,0,0,0,5,1,7,1,4,
  594. 4,6,6,6,6,6,6,1,1,1,1,2,2,2,2,2,2,2,2,2,2,2,5,5,5,5,5,5,5,5,0,0,0,0,0,0,0,0,0,0,
  595. 0,0,0,5,5,1,1,1,1,1,1,1,1,1,2,2,1,1,1,1,1,1,1,1,1,1,1,1,1,1,5,5,5,5,5,5,5,5,0,0,
  596. 0,0,0,0,0,0,0,0,0,0,0,5,5,1,1,1,1,1,1,1,1,1,3,3,1,1,1,1,9,9,9,9,9,9,9,9,9,9,5,5,
  597. 5,5,5,5,5,5,5,0,0,0,0,0,0,0,0,0,0,0,0,0,5,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,9,9,9,9,
  598. 9,9,9,9,9,9,5,5,5,5,5,5,5,5,5,0,0,0,0,0,0,0,0,0,0,0,0,0,0,1,1,1,1,1,1,1,1,1,1,1,
  599. 1,1,1,1,9,9,9,9,9,9,9,9,9,9,5,5,5,5,5,5,5,5,5,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,5,5,
  600. 1,7,7,1,7,1,5,0,0,0,0,0,0,0,0,0,0,0,0,0,0,5,5,5,5,5,5,5,5,5,5,0,0,0,0,0,0,0,0,0,
  601. 0,0,0,0,0,0,0,5,5,1,7,7,7,1,1,5,0,0,0,0,0,0,0,0,0,0,0,0,5,5,5,5,5,5,5,5,5,5,5,0,
  602. 0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,5,5,1,1,5,5,5,5,0,0,0,0,0,0,0,0,0,0,5,5,5,5,5,5,
  603. 5,5,5,5,5,5,5,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,5,5,5,0,0,0,0,0,0,0,0,0,0,0,
  604. 0,0,5,5,5,5,5,5,5,5,5,5,5,5,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,
  605. 0,0,0,0,0,0,0,0,0,0,5,5,5,5,5,5,5,5,5,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,
  606. 0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,5,5,5,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0
  607. );
  608.       frame3 : icon = (
  609. 0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,
  610. 0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,
  611. 0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,
  612. 0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,
  613. 0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,
  614. 0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,
  615. 0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,
  616. 0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,
  617. 0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,9,9,9,9,
  618. 9,9,9,9,9,9,9,5,5,5,5,5,5,5,0,0,0,0,0,0,0,0,0,0,0,0,0,7,7,1,1,1,1,1,1,1,1,1,1,1,
  619. 1,1,1,1,9,9,9,9,9,9,9,9,9,5,5,5,5,5,5,5,5,5,5,5,0,0,0,0,0,0,0,0,0,0,7,1,1,1,1,1,
  620. 1,1,0,0,0,1,1,1,1,1,1,1,9,9,9,9,9,9,9,5,5,5,5,5,5,5,5,5,5,5,5,5,0,0,0,0,0,0,0,0,
  621. 0,7,1,1,7,7,1,1,1,1,0,0,0,1,1,1,1,1,1,1,1,1,1,1,1,1,5,5,5,1,7,7,7,7,5,5,5,5,5,5,
  622. 5,0,0,0,0,0,0,0,7,1,7,7,7,1,1,1,1,1,0,0,0,1,1,1,1,1,1,2,2,2,2,2,2,5,5,1,1,1,7,7,
  623. 1,1,7,5,5,5,5,5,5,5,0,0,0,0,0,0,1,1,7,1,1,7,1,1,1,1,0,0,0,1,1,1,1,1,1,2,2,2,2,2,
  624. 2,1,7,7,7,1,7,7,7,7,7,5,5,5,5,5,5,5,5,0,0,0,0,0,1,7,7,7,7,1,1,1,1,1,0,0,0,1,1,1,
  625. 1,1,1,2,2,2,2,2,2,1,7,7,7,7,7,7,7,1,1,5,5,5,5,5,5,5,5,5,0,0,0,0,7,7,1,7,1,7,1,1,
  626. 1,1,0,0,0,1,1,1,1,1,1,2,2,2,2,2,2,2,1,1,1,1,1,1,2,2,5,5,5,5,5,5,5,5,5,5,5,0,0,0,
  627. 7,7,7,7,7,1,1,1,1,1,0,0,0,1,1,1,1,1,1,2,2,2,2,2,2,2,2,2,2,2,2,2,2,2,5,5,5,5,5,5,
  628. 5,5,5,5,5,0,0,0,7,7,0,0,7,7,1,1,1,1,0,0,0,1,1,1,1,1,1,2,2,2,2,2,2,2,2,2,2,2,2,2,
  629. 2,2,5,5,0,0,5,5,0,5,5,0,0,0,0,0,0,0,0,0,0,0,1,1,1,1,0,0,0,1,1,1,1,1,1,2,2,2,2,2,
  630. 2,2,2,2,2,2,2,2,2,2,2,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,1,1,1,1,0,0,0,1,1,1,
  631. 1,1,1,2,2,2,2,2,2,2,2,2,2,2,2,2,2,2,2,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,1,4,
  632. 4,6,6,6,6,6,6,1,1,1,1,2,2,2,2,2,2,2,2,2,2,2,2,2,2,2,2,0,0,0,0,0,0,0,0,0,0,0,0,0,
  633. 0,0,0,0,0,0,1,1,1,1,1,1,1,1,2,2,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,0,0,0,0,0,
  634. 0,0,0,0,0,0,0,0,0,0,0,0,0,1,1,1,1,1,1,1,1,1,3,3,1,1,1,1,9,9,9,9,9,9,9,9,9,9,9,9,
  635. 9,9,9,9,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,9,9,9,9,
  636. 9,9,9,9,9,9,9,9,9,9,9,9,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,1,1,1,1,1,1,1,1,1,1,1,
  637. 1,1,1,1,9,9,9,9,9,9,9,9,9,9,9,9,9,9,9,9,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,
  638. 0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,
  639. 0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,
  640. 0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,
  641. 0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,
  642. 0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,
  643. 0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,
  644. 0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0
  645. );
  646.  
  647.  
  648. VAR Virscr : VirtPtr;                      { Our first Virtual screen }
  649.     VirScr2 : VirtPtr;                     { Our second Virtual screen }
  650.     Vaddr  : word;                      { The segment of our virtual screen}
  651.     Vaddr2 : Word;                      { The segment of our 2nd virt. screen}
  652.     ourpal : Array [0..255,1..3] of byte; { A virtual pallette }
  653.     toaster : Array [1..10] of toastinfo; { The toaster info }
  654.  
  655. {──────────────────────────────────────────────────────────────────────────}
  656. Procedure SetMCGA;  { This procedure gets you into 320x200x256 mode. }
  657. BEGIN
  658.   asm
  659.      mov        ax,0013h
  660.      int        10h
  661.   end;
  662. END;
  663.  
  664.  
  665. {──────────────────────────────────────────────────────────────────────────}
  666. Procedure SetText;  { This procedure returns you to text mode.  }
  667. BEGIN
  668.   asm
  669.      mov        ax,0003h
  670.      int        10h
  671.   end;
  672. END;
  673.  
  674. {──────────────────────────────────────────────────────────────────────────}
  675. Procedure Cls (Col : Byte; Where:word);
  676.    { This clears the screen to the specified color }
  677. BEGIN
  678.      asm
  679.         push    es
  680.         mov     cx, 32000;
  681.         mov     es,[where]
  682.         xor     di,di
  683.         mov     al,[col]
  684.         mov     ah,al
  685.         rep     stosw
  686.         pop     es
  687.      End;
  688. END;
  689.  
  690.  
  691. {──────────────────────────────────────────────────────────────────────────}
  692. Procedure Putpixel (X,Y : Integer; Col : Byte; where:word);
  693.   { This puts a pixel on the screen by writing directly to memory. }
  694. BEGIN
  695.   Asm
  696.     push    ds
  697.     push    es
  698.     mov     ax,[where]
  699.     mov     es,ax
  700.     mov     bx,[X]
  701.     mov     dx,[Y]
  702.     push    bx                      {; and this again for later}
  703.     mov     bx, dx                  {; bx = dx}
  704.     mov     dh, dl                  {; dx = dx * 256}
  705.     xor     dl, dl
  706.     shl     bx, 1
  707.     shl     bx, 1
  708.     shl     bx, 1
  709.     shl     bx, 1
  710.     shl     bx, 1
  711.     shl     bx, 1                   {; bx = bx * 64}
  712.     add     dx, bx                  {; dx = dx + bx (ie y*320)}
  713.     pop     bx                      {; get back our x}
  714.     add     bx, dx                  {; finalise location}
  715.     mov     di, bx
  716.     {; es:di = where to go}
  717.     xor     al,al
  718.     mov     ah, [Col]
  719.     mov     es:[di],ah
  720.     pop     es
  721.     pop     ds
  722.   End;
  723. END;
  724.  
  725.  
  726. {──────────────────────────────────────────────────────────────────────────}
  727. procedure WaitRetrace; assembler;
  728.   {  This waits for a vertical retrace to reduce snow on the screen }
  729. label
  730.   l1, l2;
  731. asm
  732.     mov dx,3DAh
  733. l1:
  734.     in al,dx
  735.     and al,08h
  736.     jnz l1
  737. l2:
  738.     in al,dx
  739.     and al,08h
  740.     jz  l2
  741. end;
  742.  
  743.  
  744. {──────────────────────────────────────────────────────────────────────────}
  745. Procedure Pal(Col,R,G,B : Byte);
  746.   { This sets the Red, Green and Blue values of a certain color }
  747. Begin
  748.    asm
  749.       mov    dx,3c8h
  750.       mov    al,[col]
  751.       out    dx,al
  752.       inc    dx
  753.       mov    al,[r]
  754.       out    dx,al
  755.       mov    al,[g]
  756.       out    dx,al
  757.       mov    al,[b]
  758.       out    dx,al
  759.    end;
  760. End;
  761.  
  762. {──────────────────────────────────────────────────────────────────────────}
  763. Procedure GetPal(Col : Byte; Var R,G,B : Byte);
  764.   { This gets the Red, Green and Blue values of a certain color }
  765. Var
  766.    rr,gg,bb : Byte;
  767. Begin
  768.    asm
  769.       mov    dx,3c7h
  770.       mov    al,col
  771.       out    dx,al
  772.  
  773.       add    dx,2
  774.  
  775.       in     al,dx
  776.       mov    [rr],al
  777.       in     al,dx
  778.       mov    [gg],al
  779.       in     al,dx
  780.       mov    [bb],al
  781.    end;
  782.    r := rr;
  783.    g := gg;
  784.    b := bb;
  785. end;
  786.  
  787. {──────────────────────────────────────────────────────────────────────────}
  788. Procedure SetUpVirtual;
  789.    { This sets up the memory needed for the virtual screen }
  790. BEGIN
  791.   GetMem (VirScr,64000);
  792.   vaddr := seg (virscr^);
  793.   GetMem (VirScr2,64000);
  794.   vaddr2 := seg (virscr2^);
  795. END;
  796.  
  797.  
  798. {──────────────────────────────────────────────────────────────────────────}
  799. Procedure ShutDown;
  800.    { This frees the memory used by the virtual screen }
  801. BEGIN
  802.   FreeMem (VirScr,64000);
  803.   FreeMem (VirScr2,64000);
  804. END;
  805.  
  806.  
  807. {──────────────────────────────────────────────────────────────────────────}
  808. procedure flip(source,dest:Word);
  809.   { This copies the entire screen at "source" to destination }
  810. begin
  811.   asm
  812.     push    ds
  813.     mov     ax, [Dest]
  814.     mov     es, ax
  815.     mov     ax, [Source]
  816.     mov     ds, ax
  817.     xor     si, si
  818.     xor     di, di
  819.     mov     cx, 32000
  820.     rep     movsw
  821.     pop     ds
  822.   end;
  823. end;
  824.  
  825.  
  826. {──────────────────────────────────────────────────────────────────────────}
  827. Procedure putico(X,Y:Word;VAR sprt : icon;Where:Word); ASSEMBLER;
  828.   { This puts an icon, EXCEPT it's color 0 (black) pixels, onto the screen
  829.     "where", at position X,Y }
  830. label
  831.   _Redraw, _DrawLoop, _Exit, _LineLoop, _NextLine, _Store, _NoPaint;
  832.  
  833. asm
  834.     push  ds
  835.     push  es
  836.     lds   si,Sprt
  837.     mov   ax,X     { ax = x }
  838.     mov   bx,Y     { bx = y }
  839. _Redraw:
  840.     push    ax
  841.     mov     ax,[where]
  842.     mov     es,ax
  843.  
  844.     mov     ax, bx                  {; ax = bx  x = y}
  845.     mov     bh, bl                  {; y = y * 256  bx = bx * 256}
  846.     xor     bl, bl
  847.     shl     ax, 1
  848.     shl     ax, 1
  849.     shl     ax, 1
  850.     shl     ax, 1
  851.     shl     ax, 1
  852.     shl     ax, 1                   {; y = y * 64   ax = ax * 64}
  853.     add     bx, ax                  {; y = (y*256) + (Y*64)  bx = bx + ax (ie y*320)}
  854.  
  855.     pop     ax                      {; get back our x}
  856.  
  857.  
  858.     add     ax, bx                  {; finalise location}
  859.     mov     di, ax
  860.  
  861.     mov   dl,30    { dl = height of sprite }
  862.     xor   ch,ch
  863.     mov   cl,48     { cx = width of sprite }
  864.     cld
  865.     push  ax
  866.     mov   ax,cx
  867. _DrawLoop:
  868.     push  di            { store y adr. for later }
  869.     mov   cx,ax          { store width }
  870. _LineLoop:
  871.     mov   bl,byte ptr [si]
  872.     or    bl,bl
  873.     jnz   _Store
  874. _NoPaint:
  875.     inc    si
  876.     inc    di
  877.     loop   _LineLoop
  878.     jmp    _NextLine
  879. _Store:
  880.     movsb
  881.     loop  _LineLoop
  882. _NextLine:
  883.     pop   di
  884.     dec   dl
  885.     jz    _Exit
  886.     add   di,320        { di = next line of sprite }
  887.     jmp   _DrawLoop
  888. _Exit:
  889.     pop   ax
  890.     pop   es
  891.     pop   ds
  892. end;
  893.  
  894.  
  895.  
  896.  
  897.  
  898. {──────────────────────────────────────────────────────────────────────────}
  899. Procedure Funny_line(a,b,c,d:integer;where:word);
  900.   { This procedure draws a line from a,b to c,d on screen "where". After
  901.     each pixel it plots, it increments a color counter for the next pixel.
  902.     you may easily alter this to be a normal line procedure, and it will
  903.     be quite a bit faster than the origional one I gave you. This is
  904.     because I replaced all the reals with integers. }
  905.  
  906.   function sgn(a:real):integer;
  907.   begin
  908.        if a>0 then sgn:=+1;
  909.        if a<0 then sgn:=-1;
  910.        if a=0 then sgn:=0;
  911.   end;
  912. var i,s,d1x,d1y,d2x,d2y,u,v,m,n:integer;
  913.     count:integer;
  914. begin
  915.      count:=50;
  916.      u:= c - a;
  917.      v:= d - b;
  918.      d1x:= SGN(u);
  919.      d1y:= SGN(v);
  920.      d2x:= SGN(u);
  921.      d2y:= 0;
  922.      m:= ABS(u);
  923.      n := ABS(v);
  924.      IF NOT (M>N) then
  925.      BEGIN
  926.           d2x := 0 ;
  927.           d2y := SGN(v);
  928.           m := ABS(v);
  929.           n := ABS(u);
  930.      END;
  931.      s := m shr 1;
  932.      FOR i := 0 TO m DO
  933.      BEGIN
  934.           putpixel(a,b,count,where);
  935.           inc (count);
  936.           if count=101 then count:=50;
  937.           s := s + n;
  938.           IF not (s<m) THEN
  939.           BEGIN
  940.                s := s - m;
  941.                a:= a + d1x;
  942.                b := b + d1y;
  943.           END
  944.           ELSE
  945.           BEGIN
  946.                a := a + d2x;
  947.                b := b + d2y;
  948.           END;
  949.      end;
  950. END;
  951.  
  952.  
  953.  
  954. {──────────────────────────────────────────────────────────────────────────}
  955. Procedure SetUpScreen;
  956.   { This procedure sets up the static background to be used in the program }
  957.  
  958. CONST circ : Array [1..5,1..5] of byte =
  959.         ((0,10,10,10,0),
  960.          (10,13,12,11,10),
  961.          (10,12,12,11,10),
  962.          (10,11,11,11,10),
  963.          (0,10,10,10,0));
  964.  
  965. VAR x,y:integer;
  966.     loop1,loop2,loop3:integer;
  967.  
  968. BEGIN
  969.   pal (1,22,22,22);
  970.   pal (2,45,45,45);
  971.   pal (3,59,59,59);
  972.   pal (4,63,63,27);
  973.   pal (5,39,63,3);
  974.   pal (6,51,39,3);
  975.   pal (7,3,27,3);
  976.   pal (8,15,39,15);
  977.   pal (9,35,35,35);
  978.   pal (10, 0, 0,40);
  979.   pal (11,10,10,50);
  980.   pal (12,20,20,60);
  981.   pal (13,30,30,63);
  982.  
  983.   For loop1:=50 to 100 do
  984.     pal (loop1,0,0,loop1-36);
  985.  
  986.   For loop1:=0 to 255 do
  987.      getpal (loop1,OurPal[loop1,1],OurPal[loop1,2],OurPal[loop1,3]);
  988.  
  989.   For loop1:=0 to 319 do
  990.     Funny_line (0,199,loop1,0,vaddr);
  991.   For loop1:=0 to 199 do
  992.     Funny_line (0,199,319,loop1,vaddr);
  993.  
  994.   For loop1:=1 to 200 do BEGIN
  995.     x:=random (315);
  996.     y:=random (195);
  997.     For loop2:=1 to 5 do
  998.       For loop3:=1 to 5 do
  999.         if circ [loop2,loop3]<>0 then
  1000.           putpixel (x+loop2,y+loop3,circ [loop2,loop3],vaddr);
  1001.   END;
  1002.   flip (vaddr,vga);  { Copy the entire screen at vaddr, our virtual screen }
  1003.                      { on which we have done all our graphics, onto the    }
  1004.                      { screen you see, VGA }
  1005.   flip (vaddr,vaddr2);
  1006. END;
  1007.  
  1008.  
  1009. {──────────────────────────────────────────────────────────────────────────}
  1010. Procedure rotatepal;
  1011.   { This procedure rotates the colors between 50 and 100 }
  1012. VAR temp : Array [1..3] of byte;
  1013.     loop1:integer;
  1014. BEGIN
  1015.   Move(OurPal[100],Temp,3);
  1016.   Move(OurPal[50],OurPal[51],50*3);
  1017.   Move(Temp,OurPal[50],3);
  1018.   For loop1:=50 to 100 do
  1019.     pal (loop1,OurPal[loop1,1],OurPal[loop1,2],OurPal[loop1,3]);
  1020. END;
  1021.  
  1022.  
  1023. {──────────────────────────────────────────────────────────────────────────}
  1024. Procedure ScreenTrans (x,y:word);
  1025.   { This is a small procedure to copy a 30x30 pixel block from coordinates
  1026.     x,y on the virtual screen to coordinates x,y on the true vga screen }
  1027. BEGIN
  1028.   asm
  1029.     push    ds
  1030.     push    es
  1031.     mov     ax,vaddr
  1032.     mov     es,ax
  1033.     mov     ax,vaddr2
  1034.     mov     ds,ax
  1035.     mov     bx,[X]
  1036.     mov     dx,[Y]
  1037.     push    bx                      {; and this again for later}
  1038.     mov     bx, dx                  {; bx = dx}
  1039.     mov     dh, dl                  {; dx = dx * 256}
  1040.     xor     dl, dl
  1041.     shl     bx, 1
  1042.     shl     bx, 1
  1043.     shl     bx, 1
  1044.     shl     bx, 1
  1045.     shl     bx, 1
  1046.     shl     bx, 1                   {; bx = bx * 64}
  1047.     add     dx, bx                  {; dx = dx + bx (ie y*320)}
  1048.     pop     bx                      {; get back our x}
  1049.     add     bx, dx                  {; finalise location}
  1050.     mov     di, bx                  {; es:di = where to go}
  1051.     mov     si, di
  1052.     mov     al,60
  1053.     mov     bx, 30         { Hight of block to copy }
  1054. @@1 :
  1055.     mov     cx, 24         { Width of block to copy divided by 2 }
  1056.     rep     movsw
  1057.     add     di,110h        { 320 - 48 = 272 .. or 110 in hex }
  1058.     add     si,110h
  1059.     dec     bx
  1060.     jnz     @@1
  1061.  
  1062.     pop     es
  1063.     pop     ds
  1064.   end;
  1065.   { I wrote this procedure late last night, so it may not be in it's
  1066.     most optimised state. Sorry :-)}
  1067. END;
  1068.  
  1069.  
  1070. {──────────────────────────────────────────────────────────────────────────}
  1071. Procedure NewToaster;
  1072.   { This adds a new toaster to the screen }
  1073. VAR loop1:integer;
  1074. BEGIN
  1075.   loop1:=0;
  1076.   repeat
  1077.     inc (loop1);
  1078.     if not (toaster[loop1].active) then BEGIN
  1079.       toaster[loop1].x:=random (200)+70;
  1080.       toaster[loop1].y:=0;
  1081.       toaster[loop1].active:=true;
  1082.       toaster[loop1].frame:=1;
  1083.       toaster[loop1].speed:=Random (3)+1;
  1084.       loop1:=10;
  1085.     END;
  1086.   until loop1=10;
  1087. END;
  1088.  
  1089.  
  1090. {──────────────────────────────────────────────────────────────────────────}
  1091. Procedure Fly;
  1092.   { This is the procedure where we move and put the toasters }
  1093. VAR loop1,loop2:integer;
  1094.     ch:char;
  1095. BEGIN
  1096.   For loop1:=1 to 10 do
  1097.     toaster[loop1].active:=FALSE;
  1098.   ch:=#0;
  1099.   NewToaster;
  1100.   Repeat
  1101.     if keypressed then BEGIN
  1102.       ch:=readkey;
  1103.       if ch='+' then NewToaster;      { If '+' is pressed, add a toaster }
  1104.       if ch='-' then BEGIN            { if '-' is pressed, remove a toaster }
  1105.         loop1:=0;
  1106.         repeat
  1107.           inc (loop1);
  1108.           if toaster[loop1].active then BEGIN
  1109.             screentrans (toaster[loop1].x,toaster[loop1].y);
  1110.             toaster [loop1].active:=FALSE;
  1111.             loop1:=10;
  1112.           END;
  1113.         until loop1=10;
  1114.       END;
  1115.     END;
  1116.     for loop1:=1 to 10 do
  1117.       if toaster[loop1].active then BEGIN
  1118.         screentrans (toaster[loop1].x,toaster[loop1].y);
  1119.           { Restore the backgrond the toaster was over }
  1120.         dec (toaster[loop1].x,toaster[loop1].speed);
  1121.         inc (toaster[loop1].y,toaster[loop1].speed);
  1122.           { Move the toaster }
  1123.         if (toaster[loop1].x<1) or (toaster[loop1].y>170) then BEGIN
  1124.           toaster[loop1].active:=FALSE;
  1125.           NewToaster;
  1126.         END;
  1127.           { When toaster reaches the edge of the screen, render it inactive
  1128.             and bring a new one into existance. }
  1129.       END;
  1130.     for loop1:=1 to 10 do
  1131.       if toaster[loop1].active then BEGIN
  1132.         CASE toaster [loop1].frame of
  1133.            1   : putico (toaster[loop1].x,toaster[loop1].y,frame1,vaddr);
  1134.            3   : putico (toaster[loop1].x,toaster[loop1].y,frame2,vaddr);
  1135.            2,4 : putico (toaster[loop1].x,toaster[loop1].y,frame3,vaddr);
  1136.         END;
  1137.         toaster[loop1].frame:=toaster[loop1].frame+1;
  1138.         if toaster [loop1].frame=5 then toaster[loop1].frame:=1;
  1139.           { Draw all the toasters on the VGA screen }
  1140.       END;
  1141.     waitretrace;
  1142.     flip (vaddr,vga);
  1143.     rotatepal;
  1144.   Until ch=#27;
  1145. END;
  1146.  
  1147.  
  1148. BEGIN
  1149.   Randomize;       { Make sure that the RANDOM funcion really is random }
  1150.   SetupVirtual;    { Set up virtual page, VADDR }
  1151.   ClrScr;
  1152.   writeln ('Hello! This program will demonstrate the principals of animation.');
  1153.   writeln ('The program will firstly generate an arb background screen to a');
  1154.   writeln ('virtual page, then flip it to the VGA. A toaster will then start');
  1155.   writeln ('to move across the screen. Note that the background will be restored');
  1156.   writeln ('after the toaster has passed over it. You may add or remove toasters');
  1157.   writeln ('by hitting "+" or "-" respectively. Note that the more frames you');
  1158.   writeln ('use, usually the better the routine looks. Because of space');
  1159.   writeln ('restrictions, we only had room for three frames.');
  1160.   writeln;
  1161.   writeln ('The toasters were drawn by Fubar (Pieter Buys) in Autodesk Animator.');
  1162.   writeln ('I wrote a small little program to convert them into CONSTANTS. See');
  1163.   writeln ('the main text to find out how to load up AA CEL files directly.');
  1164.   writeln;
  1165.   writeln;
  1166.   Write ('  Hit any key to contine ...');
  1167.   Readkey;
  1168.   SetMCGA;
  1169.   SetupScreen;     { Draw the background screen to VADDR, then flip it to
  1170.                      the VGA screen }
  1171.   Fly;             { Make the toasters fly around the screen }
  1172.   SetText;
  1173.   ShutDown;        { Free the memory taken up by virtual page }
  1174.   Writeln ('All done. This concludes the seventh sample program in the ASPHYXIA');
  1175.   Writeln ('Training series. You may reach DENTHOR under the names of GRANT');
  1176.   Writeln ('SMITH/DENTHOR/ASPHYXIA on the ASPHYXIA BBS. I am also an avid');
  1177.   Writeln ('Connectix BBS user, which is unfortunatly offline for the moment.');
  1178.   Writeln ('For discussion purposes, I am also the moderator of the Programming');
  1179.   Writeln ('newsgroup on the For Your Eyes Only BBS.');
  1180.   Writeln ('The numbers are available in the main text. You may also write to me at:');
  1181.   Writeln ('             Grant Smith');
  1182.   Writeln ('             P.O. Box 270');
  1183.   Writeln ('             Kloof');
  1184.   Writeln ('             3640');
  1185.   Writeln ('I hope to hear from you soon!');
  1186.   Writeln; Writeln;
  1187.   Write   ('Hit any key to exit ...');
  1188.   Readkey;
  1189. END.
  1190.